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SECTION  1 
SCOPE 


1.1  Identification 


This  specification  establishes  the  design  of  Function 
PRE9.1,  "Request  Processor  Generator  Support  Routines",  one  of 
the  major  functions  of  the  Configuration  Item  (Cl)  "Precompiler" 
to  be  built  and  formally  accepted  by  the  ICAM  Program  Office. 
This  Cl  constitutes  one  of  the  subsystems  of  the  Common  Data 
Model  Processor  (CDMP) . 


1 . 2  Functional  Summary 

The  purpose  of  this  Computer  Program  Configuration  Item 
(CPCI)  is  to  provide  code  generation  support  functions  to  the 
CDMP  Request  Processor  generators. 

The  following  functions  will  be  performed  by  this  CPCI: 

1.  Generate  working  storage  and  procedure  division  code 
for  the  conceptual  schema  to  internal  schema 
transformation  of  runtime  search  parameters  and  update 
values  (CDCI) . 

2.  Combine  two  work  files  into  one  file  containing  the 
Request  Processor  program  (CDCWF) . 

3.  Generate  working  storage  and  procedure  division  code 
for  the  internal  schema  to  conceptual  schema 
transformation  of  retrieved  data  fields  (CDIC) . 

4.  Generate  macro  code  with  the  proper  substitution 
parameters  (CDMACR) . 

5.  Generate  conceptual  schema  data  definitions  for  runtime 
search  parameters  and  update  values  (CDMSG) . 

6.  Generate  internal  schema  data  definitions  for  runtime 
search  parameters  (CDPRM) . 

7.  Generate  internal  schema  data  definitions  for  qualified 
data  fields  (CDQDF) . 

8.  Generate  internal  schema  data  definitions  for  retrieved 
data  fields  (CDRDF) . 

9.  Generate  conceptual  schema  data  definitions  for 
retrieved  data  fields  (CDRFT) . 

10.  Generate  working  storage  data  definitions  for  run  time 
complex  mapping  algorithm  parameters  (CDCMPRM) . 

11.  Generate  a  COBOL  working  storage  record  layout  for  a 
specified  record  type  (CDGENRT) . 
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12.  Generate  user  defined  null  variable  names  and  picture 
clauses  (CDGNV) . 

13.  Generate  working  storage  indicator  definitions  in  support 
of  conceptual  evaluation  for  deletes  and  modifies  (CDGYU) . 

14.  Retrieval  from  the  COM  internal  schema  meta  data  (type, 
size,  and  number  of  decimals)  for  a  specified  data  field 
(CDIMD) . 

15.  Generate  FORTRAN  parameter  variable  initialization  (CDPOOL) . 

16.  Convert  an  NDML  operator  into  the  COBOL  equivalent  (CDQPOP) . 

17.  Generate  an  "IF"  statement  that  will  evaluate  conceptually 
user  qualifications  contained  in  a  WHERE  clause  (CDRPCIF)  . 

18.  Generate  an  "IF"  statement  that  will  evaluate  internally  user 
qualifications  contained  in  a  WHERE  clause  (CDRPIIF) . 

19.  Generate  an  "IF"  statement  that  will  evaluate  record  union 
discriminator  qualification  for  a  specified  record  type 
(CDRPUIF) . 

20.  Retrieve  from  the  COM  all  datafield  information  for  a 
specified  record  type  (RETFLDS) . 
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DOCUMENTS 


2 . 1  Reference  Documents 


1.  ICAM  Documentation  Standards:  IDS15012000A,  28 
December  1981. 

2.  D.  Appleton  Co.,  CDM  Administrators  Manual; 
UM620141000.  March  1984. 

3.  D.  Appleton  Co.,  CDMl-IDEF,  Model  of  the  Common  Data 

Model:  CCS620141000 .  15  May  1985. 

4.  D.  Appleton  Co.,  Computer  Program  Development 
Specification  (PS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDML  Precompiler; 
DS620141200,  October  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer's  Reference 
Manual;  PRM620141200,  March  1985. 

6.  Softech,  Inc.,  NTM  Programmer's  Guide;  UM620140001, 
July  1984. 

7.  Control  Data  Corporation,  Computer  Program  Development 
Specification  (PS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item;  NDDL  Command  Processor; 
DS620141100,  June  1985. 


2 . 2  Terms  and  Abbreviations 

Attribute  Use  Class;  (AUC) 


Conceptual  Schema:  (CS) 

Common  Data  Model  Processor;  (CDMP) 

Common  Data  Model :  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc.,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transforamtion  operators. 

Data  Field:  (DF)  An  element  of  data  in  the  external 
schema"!  It  is  by  this  name  that  an  NDML  programmer  references 
data . 


Database  Management  System:  ( DBMS ) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  NDML  queries  and  non  distributed  updates. 

Domain;  A  logical  definition  of  legal  attribute  class 
values. 
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Domain  Constraint:  Predicate  that  applies  to  a  single 
domain. 

External  Schema:  (ES) 

Forms;  Structured  views  that  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields  where  each  field  is  a 
form,  item,  or  window. 

Forms  Processor;  (FP)  A  set  of  callable  execution  time 
routines  available  to  an  application  program  for  form 
processing. 

Internal  Schema;  (IS) 

Integrated  Information  Support  System;  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
interconnected  via  a  local  Area  Network. 

Mapping;  The  correspondence  of  independent  objects  in  two 
schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager;  (NTM)  Performs  the 
coordination,  communication  and  housekeeping  functions  required 
to  integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Lanquac^e;  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieved  and  single  node 
updates . 

ORACLE ;  Relational  DBMS  based  on  the  SQL  (Structured  Query 
Language,  a  product  of  ORACLE  Corp,  Menlo  Park,  CA) .  The  CDM  is 
an  ORACLE  database. 

Parcel ;  A  sequential  file  containing  sections  source  code 
of  the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy 
a  retrieval  or  update  NDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface;  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface:  (VTI)  Performs  the  interfacting 
between  different  terminals  and  the  UI.  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  Definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules_ 
written  for  each  type  of  real  terminal  supported. 


2-2 


PS  620341260 
30  September  1990 


SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Description 

The  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI. 

Each  code  generation  support  function  is  contained  in  a 
single  COBOL  module  identified  in  Section  1.2  of  this  document. 

A  separate  module  CDPIC  is  used  by  some  of  the  support  functions 
to  generate  a  COBOL  picture  clause  for  program  variables. 


3 . 2  Functional  Flow 


This  CPCI  implemented  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs/outputs  and 
relationships  between  modules  are  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is,  the  Network  Transaction  Manager. 
It  currently  can  only  be  executed  on  the  DEC  VAX  due  to  the 
dependence  on  the  VAX  sort  although  this  can  be  changed  for 
execution  on  the  IBM. 


3.3  Interfaces 


The  following  diagram  depicts  the  interface  of  PRE9.1  with 
oth  r  CPCI's  in  the  system. 
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3.3.1  Inputs/Outputs 

The  inputs  and  outputs  of  each  module  in  this  CPCI  can  be 
found  in  section  3.10.  A  detailed  description  for  each  item  can 
be  found  in  the  DS  for  this  CPCI. 
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Program  Interrupts 
Not  applicable  to  the  CPCI. 

3 . 5  Timing  and  Sequencing  Description 

This  CPCI  is  called  upon  by  each  Request  Processor 
generator. 

3 . 6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

3 . 7  Storage  Allocation 

3.7.1  Database  Definition 

The  database  used  by  this  CPCI  is  the  Common  Data  Model 
(CDM)  database.  The  model  is  defined  by  the  CDMl  and  the  IDEF-1 
model  of  the  CDM,  Reference  Number  3. 

3.7. 1.1  File  Description 

No  permanent  files  have  been  defined  for  this  CPCI.  It 
uses  temporary  scratch  files  for  the  generated  program  source 
code. 


3 . 7 . 1 . 2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI 


3.7. 1.3  Item  Description 

Not  applicable  to  this  CPCI. 


3 . 8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  team  using  defined  IISS  Software  Configuration 
Management  procedures.  This  CPCI  will  use  the  COBOL 
language  compiler. 


3 . 9  Adaptation  Data 

This  CPCI  has  been  coded  using  ANSI  COBOL  language.  The 
intent  was  to  provide  a  transportable  system.  Any  system 
environment  supporting  these  languages,  a  virtual  memory 
management  schema,  the  COMM  and  NTM  subsystems  of  IISS  and  the 
ORACLE  Database  Management  System  should  be  able  to  support  this 
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CPCI.  Every  possible  attempt  has  been  made  to  localize  and 
identify  any  machine  or  environment  dependent  modules  through 
the  original  design  of  the  IISS  and  application  of  Configuration 
Management  Procedures. 


3.10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 


3.10.1  Where  Include  File  Used  List 

The  following  lists  each  include  file  in  the 
documentation  group  and  all  the  modules  documented  in  thi.^ 
specification  which  include  them.  The  purpose  of  each 
module  is  listed  as  well. 


DOCGROUP  PS41260  Where-include-f ile-used  List 


Include  Module 

File  Name 


ERRCDM 


ERRFS 


CDCI 

CDCMPRM 

CDCWF 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDIMD 

CDMACR 

CDMSG 

CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 

CDRPCIF 

CDRPIIF 

CDRPUIF 

RETFLDS 

CDCI 

CDCMPRM 

CDCWF 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDMACR 

CDMSG 
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Include 

File 


MAC DAT 

SBSTLST 

ISAL 

ISQUAL 


Module 

Name 


CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 

CDRPCIF 

CDRPIIF 

CDRPUIF 

CDCI 

CDIC 

CDMACR 

CDCI 

CDIC 

CDMACR 

CDCI 

CDGNV 

CDIC 

CDMSG 

CDMSG2 

CDPOOL 

CDRDF 

CDCI 

CDGNV 

CDGTV 

CDIC 

CDMSG 
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Include 

File 


CSAL 


CSQUAL 


CHAT 


FORVAR 
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PS41260  Where- include-file-used  List 


Module 

Name 


CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRPCIF 

CDRPIIF 

CDRPUIF 

CDCI 

CDMSG 

CDMSG2 

CDPOOL 

CDRPCIF 

CDCI 

CDGTV 

CDIC 

CDMSG 

CDMSG 2 

CDPOOL 

CDRPCIF 

CDCI 

CDCMPRM 

CDGNV 

CDGTV 

CDIC 

CDPRM 

CDQDF 

CDRDF 
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DOCGROUP 


Include 

File 


ERRPRO 


PS41260  Where-include-f ile-used  List 


Module 

Name 


CDCI 

CDCMPRM 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDMSG 

CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 

CDRPCIF 

CDCI 

CDCMPRM 

CDCWF 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDIMD 

CDMACR 

CDMSG 

CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 
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DOCGROUP  PS41260  Where-include-f ile-used  List 


Include 

Module 

File 

Name 

CDRPCIF 

CDRPIIF 

CDRPUIF 

RETFLDS 


CHKCDM 

CDCMPRM 

CDGENRT 

CDGNV 

CDGTV 

CDIMD 

CDRPCIF 

CDRPIIF 

CDRPUIF 

TDFTBL 

CDGENRT 

RETFLDS 

RFTABLE 

CDIC 

CDRFT 

EOD 

CDIMD 

CDMACR 

RETFLDS 

COBOLOP 

CDQPOP 

ERRORST 

CDQPOP 

BOOLST 

CDRPCIF 

SUBBOOL 

CDRPIIF 

DOCGROUP  PS41260  Where-include-f ile-used  List 


Include 

File 


Module 

Name 


CDRPUIF 
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3.10.2  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
in  the  documentation  group  and  all  the  documented  modules 
which  call  it.  The  purpose  of  each  module  is  listed  as 
well . 


DOCGROUP  PS41260  Where-external-routine-used  List 


System  Module 

Module  Name 


CDGETOF 


OUTFIL 


CDCI 

CDCMPRM 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDMSG 

CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 

CDRPCIF 

CDCI 

CDCMPRM 

CDCWF 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDMACR 

CDMSG 

CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 
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DOCGROUP 


System 

Module 


ERRPRO 


CDCREFO 


PS41260  Where-external-routine-used  List 


Module 

Name 


CDRPCIF 

CDRPIIF 

CDRPUIF 


CDCI 

CDCMPRM 

CDCWF 

CDGENRT 

CDGNV 

CDGTV 

CDIC 

CDIMD 

CDMACR 

CDMSG 

CDMSG2 

CDPOOL 

CDPRM 

CDQDF 

CDRDF 

CDRFT 

CDRPCIF 

CDRPIIF 

CDRPUIF 

RETFLDS 

CDCMPRM 

CDGENRT 

CDGNV 

CDGTV 

CDMSG 

CDMSG2 
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DOCGROUP  PS41260  Where-external-routine-used  List 


System 

Module 

Module 

Name 

CDPRM 

CDQDF 

CDRDF 

CDRFT 


OPNFIL 

CDCWF 

INPFIL 

CDCWF 

CLSFIL 

CDCWF 

SQLSCA 

CDIMD 

CDMACR 

RETFLDS 

SQLBSl 

CDIMD 

CDMACR 

RETFLDS 

SQLSCH 

CDIMD 

CDMACR 

RETFLDS 

SQLSCC 

CDIMD 

CDMACR 

RETFLDS 

SQLTFL 

CDIMD 

SQLOPN 

CDIMD 

SQLOSQ 

3-10 


PS  620341260 
30  September  1990 


DOCGROUP  PS41260  Where-external-routine-used  List 


System 

Module 

Module 

Name 

CDIMD 

CDMACR 

RETFLDS 

SQLADR 

CDIMD 

CDMACR 

RETFLDS 

SQLABl 

CDIMD 

CDMACR 

RETFLDS 

SQLEXE 

CDIMD 

CDMACR 

RETFLDS 

SQLADl 

CDIMD 

CDMACR 

RETFLDS 

SQLFCH 

CDIMD 

CDMACR 

RETFLDS 

SQLTOC 

CDMACR 

RETFLDS 

SQLCLS 

CDMACR 

RETFLDS 
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3.10.3  Main  Program  Parts  List 

The  following  lists  each  Main  Program  in  the 
documentation  group  and  all  the  modules  which  are  called 
either  by  that  module  itself  or  by  any  of  the  documented 
modules  which  it  calls.  It  is  possible  for  a  non-main 
module  to  be  listed  more  that  once  if  it  is  called  by 
multiple  modules.  The  called  modules,  in  this  case  known  as 
program  parts,  are  marked  as  to  whether  they  are  documented 
here.  If  so,  the  phrase  "well-defined  module"  appears  by 
the  module  name,  if  not  it  is  an  "external  "routine".  The 
Purpose  of  the  Main  Program  module  is  listed  as  well. 


DOCGROUP  PS41260  Main  Program  Parts  List 


Main  Pgm 
Name 


CDCI 


CDCMPRM 


CDCWF 


CDGENRT 


CDGNV 


Module 

Module 

Name 

Type 

CDMACR 

Well-defined  module 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

Well-defined  module 

CDCREFO 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

OPNFIL 

External 

routine 

INPFIL 

External 

routine 

CLSFIL 

External 

routine 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

Well-defined  module 

CDCREFO 

External 

routine 

RETFLDS 

Well-defined  module 

CDIMD 

Well-defined  module 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

Well-defined  module 

CDCREFO 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


CDGTV 


CDIC 


CDIMD 


CDMACR 


PS41260  Main  Program  Parts  List 


Module 

Name 

Module 

Type 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

Well-defined  module 

CDCREFO 

External 

routine 

CDMACR 

Well-defined  module 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLTFL 

External 

routine 

SQLOPN 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 
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DOCGROUP  PS41260  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SQLSCC 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

SQLTOC 

External 

routine 

SQLCLS 

External 

routine 

CDMSG 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

Well-defined  module 

CDCREFO 

External 

routine 

CDMSG2 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDCREFO 

External 

routine 

CDPIC 

CDPIC8 

CDPOOL 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPRM 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

External 

routine 
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DOCGROUP  PS41260  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CDCREFO 

External 

routine 

CDQDF 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

External 

routine 

CDCREFO 

External 

routine 

CDQPOP 

CDRDF 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

External 

routine 

CDCREFO 

External 

routine 

CDRFT 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDPIC 

External 

routine 

CDCREFO 

External 

routine 

CDRPCIF 

CDGETOF 

External 

routine 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDQPOP 

External 

routine 

CDRPIIF 

OUTFIL 

External 

routine 

ERRPRO 

External 

routine 

CDQPOP 

External 

routine 

CDRPUIF 

OUTFIL 

External 

routine 
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DOCGROUP 


Main  Pgm 
Name 


RETFLDS 


PS41260  Main  Program  Parts  List 


Module 

Name 

Module 

Type 

ERRPRO 

External 

routine 

CDQPOP 

External 

routine 

ERRPRO 

External 

routine 

SQLSCA 

External 

routine 

SQLBSl 

External 

routine 

SQLSCH 

External 

routine 

SQLSCC 

External 

routine 

SQLOSQ 

External 

routine 

SQLADR 

External 

routine 

SQLABl 

External 

routine 

SQLEXE 

External 

routine 

SQLADl 

External 

routine 

SQLFCH 

External 

routine 

SQLTOC 

External 

routine 

SQLCLS 

External 

routine 
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3.10.4  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  in  the 
documentation  group  being  documented  in  this  specification. 
It  provides  a  compact  way  of  getting  information  that  would 
be  otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 

Name  of  program  Module. 

PURPOSE : 

Purpose  of  Module  as  detailed  in  the 
source  code. 

LANGUAGE : 

Programming  language  source  code  is 
written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-1  Workbench  'C') 

VAX- 11  COBOL 

MODULE  TYPE: 

Whether  a  Program,  Subroutine,  or 
Function. 

SOURCE  FILE: 

Name  of  Source  File  from  file 
specification. 

SOURCE  FILE  TYPE: 

Source  File  Extension  from  file 
specification. 

HOST: 

Whether  this  is  a  host-dependent 
routine  (VAX  or  IBM)  or  blank  if 
host-independent . 

SUBSYSTEM: 

IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY: 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 

DOCUMENTATION  GROUP: 

Name  of  documentation  group  of  which 
this  source  file  is  a  member. 

DESCRIPTION: 

A  description  of  the  module  as  otained 
from  the  source  code. 

ARGUMENTS : 

The  arguments  with  which  this  routine 
is  calleu  if  it  is  a  Subroutine  or  a 
Function. 

INCLUDE  FILES: 

A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 

ROUTINES  CALLED: 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 
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CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM (S) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10,3. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 


DOCGROUP  PS41260  Module  Documentation 


NAME :  CDCI 

PURPOSE:  GENERATE  PROCEDURE  DIVISION  CODE  FOR  CS  TO  IS 
TRANSFORM 

LANGUAGE:  VAX- 11  COBOL 
SOURCE  FILE:  CDCI 
SOURCE  FILE  TYPE:  COB 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 
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DESCRIPTION: 


THIS  ROUTINE  WILL  GENERATE  ANSI  X3. 23-1974  COBOL 
CDCI  TRANSFORMS  IS-ACTION  ENTRIES  FOR  INSERTS  AND  MODIFYS. 
IT  ALSO  TRANSFORMS  TYPE  2  IS-QUALIFY  ENTRIES  FOR  SELECTS, 
TYPE  1  AND  2  REFERENTIAL  INTEGRITY  TESTS,  KEY  UNIQUENESS 
TESTS,  MODIFYS  AND  DELETES.  IN  ADDITION,  CDCI  SETS  UP 
NATIVE  DATA  BASE  OR  USER  DEFINED  NULL  VALUE  POPULATION 
OF  UNMAPPED  DATA  FIELDS  FOR  INSERTS.  CDCI  ALSO  TRANSFORMS 
UNION  VALUES. 


ARGUMENTS : 


FCB-W 

FCB2-W 

MY-HOST 

SUBTRANS-ID 

IS-ACTION-LIST 

IS-QUALIFY-LIST 

CS-ACTION-LIST 

CS-QUALIFY-LIST 

COMPLEX-MAPPING-ALG-TABLE 

NUMERIC-NULL 

CHAR-NULL 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

STRING-EXPANSION-FLAG 

RET-STATUS 


DSPLY[S9 (9) ] 

DSPLY[S9 (9)  ] 

DSPLY[X(3)  ] 

DSPLY[999] 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

DSPLY[X(30) ] 
DSPLY[X(30) ] 
DSPLY[X(10) ] 
RECRD 
DSPLY[X] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRCDM 

ERRFS 

MACDAT 

SBSTLST 

ISAL 

ISQUAL 

CSAL 

CSQUAL 

CMAT 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


CDMACR 

CDGETOF 

OUTFIL 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 


NAME:  CDCMPRM 

PURPOSE:  GENERATE  WS  DATA  DEFINITIONS  FOR  CMA  PARAMETERS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDCMPRM 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  WORKING  STORAGE 
DATA  DEFINITIONS  REQUIRED  FOR  THE  RUN  TIME 
COMPLEX  MAPPING  ALGORITHM  PARAMETERS. 

MODIFIED  9/88  -  RELEASE  2.5 
GENERATE  CODE  IN  COBOL,  C,  OR  FORTRAN. 


ARGUMENTS : 


COMPLEX-MAPPING-ALG-TABLE 

SUBTRANS-ID 

FCB-W 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


RECRD 
DSPLY[999] 
DSPLY[S9(9) ] 
DSPLY[X(10) ] 
RECRD 

DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

CMAT 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 


NAME:  CDCWF 

PURPOSE:  COMBINES  WORKFILES  FOR  QP  INTO  ONE  FILE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDCWF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  COMBINE  THE  TWO  WORK  FILES 
USED  IN  GENERATING  THE  QUERY  PROCESSOR  INTO 
ONE  FILE-  IT  WILL  APPEND  THE  SECOND  WORK  FILE 


ARGUMENTS : 


FCB-W 

PROCFILE 

HOST 

RET-STATUS 


DSPLY[S9(9) ] 
DSPLY[X(80) ] 
DSPLY[X(3) ] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRFS 

ERRCDM 

ERRPRO 


ROUTINES  CALLED: 


OPNFIL 

INPFIL 

OUTFIL 

CLSFIL 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 


NAME:  CDGENRT 

PURPOSE:  GENERATE  A  RECORD  STRUCTURE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDGENRT 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  FUNCTION  WILL  GENERATE  A  COBOL  WORKING 
STORAGE  RECORD  LAYOUT  FOR  A  SPECIFIED  RECORD 
TYPE. 

MODIFIED  9/88  -  RELEASE  2.5 
GENERATE  IN  COBOL,  C,  OR  FORTRAN. 


ARGUMENTS : 


DB-ID 

RT-ID 

FCB-W 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


DSPLY[S9(6) ] 
DSPLY[X(30)  ] 
DSPLY[S9(9) ] 
DSPLY[X(10) ] 
RECRD 

DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

TDFTBL 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


RETFLDS 

CDIMD 

CDPIC 

OUTFIL 

CDCREFO 

CDGETOF 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 
NAME:  CDGNV 

PURPOSE:  GENERATE  USER-DEFINED  NULL  PIC  CLAUSES 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDGNV 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  USER-DEFINED  NULL 
VARIABLE  NAMES  AND  PICTURE  CLAUSES  INTO  THE 
SQL  REQUEST  PROCESSOR  WORKING  STORAGE  SECTION. 
THE  VARIABLES  GENERATED  BY  THIS  PROGRAM  WILL 
PARTICIPATE  IN  THE  SQL  WHERE  CLAUSE. — 5/16/86 

MODIFIED  9/88  -  RELEASE  2.5 

GENERATE  CODE  IN  COBOL,  C,  AND  FORTRAN. 


ARGUMENTS : 


IS-QUALIFY-LIST 

IS-ACTION-LIST 

COMPLEX-MAPPING-ALG-TABLE 

SUBTRANS-ID 

NUMERIC-NULL 

CHAR-NULL 

FCB-W 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

STRING-EXPANSION-FLAG 

RET-STATUS 


RECRD 
RECRD 
RECRD 
DSPLY[999] 
DSPLY[X(30) ] 
DSPLY[X(30) ] 
DSPLY[S9(9) ] 
DSPLY[X(10)  ] 
RECRD 
DSPLY[X] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRFS 

ERRCDM 

CHKCDM 

ISQUAL 

ISAL 

CMAT 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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NAME:  CDGTV 

PURPOSE:  GENERATE  WS  TAG  VARIABLE  AND  INDICATOR  DEFINITIONS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDGTV 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  WORKING  STORAGE 
AND  INDICATOR  DEFINITIONS  IN  SUPPORT  OF 
CONCEPTUAL  EVALUATION  IN  THE  PRESENCE  OF 
COMPLEX  INTERNAL  TO  CONCEPTUAL  MAPPING  FOR 
DELETES  AND  MODIFYS. 

MODIFIED  9/88  -  RELEASE  2.5 
GENERATE  CODE  IN  COBOL,  C,  OR  FORTRAN. 


ARGUMENTS : 


RECRD 
FECRD 
RECRD 

DSPLY[S9(9)  ] 
DSPLY[999] 
DSPLY[X(10) ] 
RECRD 

DSPLY[X(5)  ] 

INCLUDE  FILES: 


COMPLEX-MAPPING-ALG-TABLE 

IS-QUALIFY-LIST 

CS-QUALIFY-LIST 

FCB-W 

SUBTRANS-ID 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


CHKCDM 

ERRCDM 

ERRFS 

ISQUAL 

CMAT 

CSQUAL 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 
NAME:  CDIC 

PURPOSE:  GENERATE  CODE  TO  PERFORM  IS  TO  CS  TRANSFORMATIONS 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDIC 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


TRANSFORM  ALL  IS -ACTION  ENTRIES  FOR  THE  CURRENT 
SUBTRANSACTION.  IF  DELETE  OR  MODIFY.  TRANSFORM 


QUALIFICATIONS  IF  NOT  ALL 
ARGUMENTS : 


FCB-W 

FCB2-W 

MY-HOST 

SUBTRANS-ID 

IS-ACTION-LIST 

COMPLEX-MAPPING-ALG-TABLE 

NUMERIC-NULL 

CHAR-NULL 

CS-QUALIFY-LIST 

IS-QUALIFY-LIST 

RFT 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

STRING-EXPANSION-FLAG 

RET-STATUS 

INCLUDE  FILES: 


ERRCDM 

ERRFS 

MACDAT 

SBSTLST 

ISAL 

CMAT 

CSQUAL 

ISQUAL 

RFTABLE 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


ERRPRO 

OUTFIL 

CDMACR 

CDGETOF 


INTERNALLY  EVALUATABLE, 


DSPLY[S9(9) ] 
DSPLY[S9(9) ] 
DSPLY[X(3) ] 
DSPLY[999] 
RECRD 
RECRD 

DSPLY[X(30) ] 
DSPLY[X(30) ] 
RECRD 
RECRD 
RECRD 

DSPLY[X(10) ] 
RECRD 
DSPLY[X] 
DSPLY[X(5) ] 
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DOCGROUP  PS41260  Module  Documentation 
NAME:  CDIMD 

PURPOSE:  RETRIEVES  INTERNAL  SCHEMA  METADATA 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDIMD 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  USE  AN  INTERNAL  DATA  FIELD  NAME, 
DATA  BASE  ID  AND  RECORD  ID  AND  ACCESS  THE  CDM  FOR 
FOR  ITS  INTERNAL  TYPE, SIZE  AND  NUMBER  OF  DECIMAL 
DIGITS. 

ROUTINE  WAS  MODIFIED  TO  USE  EMBEDDED  SQL  —  5/13/86 


SELECT  DATA  TYPE,  SIZE  AND 
FOR  A  PARTICULAR  DATA  TYPE 
GENERATE  AN  ERROR  MESSAGE. 

ARGUMENTS : 


DAT-TYP-NM 

IS-TYPE 

IS-SIZE 

IS-ND 

RET-STATUS 
INCLUDE  FILES: 


ERRCDM 

CHKCDM 

EOD 

ERRPRO 

ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTFL 

SQLOPN 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLADl 

SQLFCH 

ERRPRO 


NUMBER  OF  DECIMAL  DIGITS 
NAME.  IF  NOT  FOUND, 


DSPLY[X(30) ] 
DSPLY[X] 
DSPLY[999] 
DSPLY[99] 
DSPLY[X(5)  ] 
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DOCGROUP  PS41260  Module  Documentation 


NAME:  CDMACR 

PURPOSE:  GENERATE  MACRO  CODE  INTO  THE  NAMED  FILE 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDMACR 

SOURCE  FILE  TYPE:  PCO 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


DESCRIPTION: 


-  THIS  SUBPROGRAM  WILL  GENERATE  CODE  AS  DOES  A  MACRO 
EXPANDER  INTO  THE  NAMED  FILE.  A  LIBRARY  NAME  AND  A 
MODULE  NAME  ARE  INPUT  ALONG  WITH  A  SUBSTITUTION 
PARAMETER  LIST.  THE  MACRO  DEFINITIONS  ARE  FOUND  ON 
A  DATA  BASE.  THIS  IS  USED  INSTEAD  OF  COPY  AND 
REPLACING  STATEMENTS,  IS  MORE  GENERALIZED  AND  FLEXIBLE. 

MODIFIED  TO  ANSI  COBOL  29  APR  1986 
HLI  REPLACED  WITH  EMBEDDED  SQL  29  APR  1986 
ADD  RET-STATUS  AS  OUTPUT  PARAMETER  AND  ENHANCE 
ERROR  HANDLING  MAY  1,  1986 

SELECT  THE  MACRO  FROM  THE  CDM  AND  PERFORM  ALL 
PARAMETER  EXPANSIONS.  GENERATE  ERROR  MESSAGE  ON 
ALL  DATABASE  ERRORS  OR  IF  MACRO  NOT  FOUND. 


ARGUMENTS : 


FCB-W 

LIBRARY -NAME 
MACRO-NAME 
SUBSTITUTION-LIST 
RET-STATUS 


DSPLY[S9(9) ] 
DSPLY[X(30)  ] 
DSPLY[X(8)  ] 
RECRD 

DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRCDM 

ERRFS 

EOD 

MACDAT 

SBSTLST 

ERRPRO 
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SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTOC 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLCLS 

SQLADl 

SQLFCH 

OUTFIL 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 
NAME:  CDMSG 

PURPOSE:  GENERATE  WS  CS  DATA  DEFINITIONS  FOR  RUNTIME 
PARAMETERS 

LANGUAGE:  VAX- 11  COBOL 
SOURCE  FILE:  CDMSG 
SOURCE  FILE  TYPE:  COB 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  WORKING  STORAGE 
CONCEPTUAL  DATA  DEFINITIONS  REQUIRED  FOR  THE 
RUNTIME  SEARCH  PARAMETERS. 

MODIFIED  9/88  -  RELEASE  2.5 
GENERATE  CODE  IN  COBOL,  C,  OR  FORTRAN. 


ARGUMENTS : 


DSPLY[S9(9) ] 
DSPLY[9(3) ] 
RECRD 
RECRD 
RECRD 
RECRD 

DSPLY[X(10) ] 
RECRD 

DSPLY[X(5)  ] 

INCLUDE  FILES: 


ERRFS 

ERRCDM 

CSQUAL 

ISQUAL 

ISAL 

CSAL 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 


FCB-W 

SUBTRANS-ID 

CS-QUALIFY-LIST 

IS-QUALIFY-LIST 

IS-ACTION-LIST 

CS-ACTION-LIST 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 
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NAME:  CDMSG2 

PURPOSE:  GENERATE  CS  SEARCH  PARAMETERS  IN  C 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDMSG2 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY :  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  CONCEPTUAL 

SCHEMA  DATA  DEFINITIONS  IN  C  REQUIRED  FOR 
THE  RUNTIME  SEARCH  PARAMETERS. 

MODIFIED  9/88  -  RELEASE  2.5 
GENERATE  CODE  IN  C,  COBOL,  OR  FORTRAN. 


ARGUMENTS : 


FCB-W 

SUBTRANS-ID 

CS-QUALIFY-LIST 

CS-ACTION-LIST 

IS-QUALIFY-LIST 

IS-ACTION-LIST 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


DSPLY[S9(9) 1 

DSPLY[9(3) ] 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRFS 

ERRCDM 

CSQUAL 

ISQUAL 

ISAL 

CSAL 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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NAME:  CDPIC 

PURPOSE:  GENERATE  A  PICTURE  CLAUSE  DATA  DEFINITION  FOR  COBOL 
IDENTIFIER 

LANGUAGE:  VAX- 11  COBOL 
SOURCE  FILE:  CDPIC 
SOURCE  FILE  TYPE:  COB 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


DESCRIPTION: 


THIS  SUBROUTINE  WILL  GENERATE  A  PICTURE  CTAUSE 
DATA  DEFINITION  FOR  A  COBOL  IDENTIFIER  ACCORDING 
TO  IT'S  TYPE,SIZE(AND  DECIMAL  POINT). 

FOR  EXAMPLE  : 

9(010)  . 

X(20)  . 

S9(010) V(02) . 

9 (008) V(02) . 

THE  INPUT  PARAMETERS  OF  THIS  SUBROUTINES  ARE 

1.  IDENTIFIER  TYPE 

2.  IDENTIFIER  SIZE (LENGTH) 

3.  IDENTIFIER  LENGHT  OF  DECIMAL  POINT 
(IF  IDENTIFIER  IS  PIC  9  TYPE). 

THE  OUTPUT  OF  THIS  SUBROUTINE  IS  IN  PIC-CLAUSE 
VARIABLE 


ARGUMENTS : 


ID-TYPE 

ID-SIZE 

NO-DEC 

PIC-CLAUSE 


DSPLY[X] 
DSPLY[999] 
DSPLY[99] 
DSPLY[X(30)  ] 
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NAME:  CDPIC8 

PURPOSE:  GENERATE  A  PICTURE  CLAUSE  DATA  DEFINITION  FOR  COBOL 
IDENTIFIER 

LANGUAGE:  VAX- 11  COBOL 
SOURCE  FILE:  CDPIC8 
SOURCE  FILE  TYPE:  COB 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  SHARE 


DESCRIPTION: 


THIS  SUBROUTINE  WILL  GENERATE  A  PICTURE  CLAUSE 
DATA  DEFINITION  FOR  A  COBOL  IDENTIFIER  ACCORDING 
TO  IT'S  TYPE, SIZE (AND  DECIMAL  POINT). 

FOR  EXAMPLE  : 

9(010) . 

X(20)  . 

S9 (010) V(02) . 

9 (008)V(02) . 

THE  INPUT  PARAMETERS  OF  THIS  SUBROUTINES  ARE 

1.  IDENTIFIER  TYPE 

2.  IDENTIFIER  SIZE (LENGTH) 

3.  IDENTIFIER  LENGHT  OF  DECIMAL  POINT 
(IF  IDENTIFIER  IS  PIC  9  TYPE) . 

THE  OUTPUT  OF  THIS  SUBROUTINE  IS  IN  PIC-CLAUSE 
VARIABLE 


ARGUMENTS ; 


ID-TYPE 

ID-SIZE 

NO-DEC 

PIC-CLAUSE 


DSPLY[X] 
DSPLY[999] 
DSPLY[99] 
DSPLY[X(30) ] 
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NAME:  CDPOOL 

PURPOSE:  GENERATE  FORTRAN  PARAMETER  INITIALIZATION  FROM 
MESSAGE  POOL 
LANGUAGE:  VAX- 11  COBOL 
SOURCE  FILE:  CDPOOL 
SOURCE  FILE  TYPE:  COB 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  FORTRAN  PARAMETExv 
VARIABLE  INITIALIZATION  BY  EXTRACTING  THE  APPROPRIALr: 
STRING  FROM  THE  MSGIN  POOL. 


ARGUMENTS : 


FCB-W 

SUBTRANS-ID 

CS-QUALIFY-LIST 

CS-ACTION-LIST 

IS-QUALIFY-LIST 

IS-ACTION-LIST 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


DSPLY[S9(9) ] 

DSPLY[999] 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

DSPLY[X(5) ] 


INCLUDE  FILES: 


ERRFS 

ERRCDM 

CSQUAL 

CSAL 

ISQUAL 

ISAL 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


CDGETOF 

OUTFIL 

ERRPRO 
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NAME :  CDPRM 

PURPOSE:  GENERATE  WS  IS  DATA  DEFINTIONS  FOR  SEARCH  PARAMETERS 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  CDPRM 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  WORKING  STORAGE 
INTERNAL  DATA  DEFINITIONS  REQUIRED  FOR  THE 
RUN  TIME  SEARCH  PARAMETERS. 


ROUTINE  WAS  UPDATED  MAY  8,  1986  INORDER  TO 
GENERATE  DATA  DEFINITIONS  FOR  EACH  DATA 
FIELD  PARAMETER  OF  THE  COMPLEX  MAPPING  ALGORITHM 
TABLE . 

UPDATED  9/88  TO  GENERATE  CODE  IN  COBOL,  C,  AND 
FORTRAN . 

Updated  8/89  to  allow  for  a  character  string  size 
one  larger  than  the  internal  size  to  store  a  null 
character  for  c  code  for  ingresS  and  ingres6  dbms. 


ARGUMENTS : 


DSPLY[S9 (9) ] 
DSPLY[9 (3) ] 
RECRD 
RECRD 

DSPLY[X(10) ] 
RECRD 
DSPLY[X] 
DSPLY[X(5)  ] 

INCLUDE  FILES: 


ERRFS 

ERRCDM 

ISQUAL 

CMAT 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 


FCB-W 

SUBTRANS-ID 

IS-QUALIFY-LIST 

COMPLEX-MAPPING-ALG-TABLE 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

STRING-EXPANSION-FLAG 

RET-STATUS 
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DOCGROUP  PS41260  Module  Documentation 


NAME:  CDQDF 

PURPOSE:  GENERATED  WS  IS  DATA  DEFINTIONS  FOR  RETRIEVAL  QUAL. 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDQDF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  WORKING  STORAGE 
INTERNAL  DATA  DEFINITIONS  FOR  THE  DATA  FIELDS 
THAT  WILL  BE  USED  FOR  RETRIEVED  QUALIFICATION. 

THE  ROUTINE  WAS  UPDATED  ON  MAY  8,  1986  INORDER 
TO  HANDLE  THE  COMPLEX  MAPPING  ALGORITHM  TABLE 
ENTRIES. 

UPDATED  9/88  TO  GENERATE  CODE  IN  COBOL,  C,  OR 
FORTRAN . 


ARGUMENTS : 


FCB-W 

SUBTRANS-ID 

IS-QUALIFY-LIST 

COMPLEX-MAPPING-ALG-TABLE 

SOURCE-LANGUAGE 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


DSPLY[S9(9) ] 
DSPLY[9(3) ] 
RECRD 
RECRD 

DSPLY[X(10) ] 
RECRD 

DSPLY[X(5)  ] 


INCLUDE  FILES: 


ERRFS 

ERRCDM 

ISQUAL 

CMAT 

FORVAR 

ERRPRO 


ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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NAME:  CDQPOP 

PURPOSE:  CONVERT  NDML  OPERATOR  INTO  COBOL  OPERATOR 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  CDQPOP 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  PROGRAM  CONVERTS  AN  NDML  OPERATOR  INTO 
COBOL  EQUIVALENT 


ARGUMENTS : 


DSPLY[XX] 
DSPLY[X(10) ] 
DSPLY [ 9 ] 


INCLUDE  FILES: 


NDML-OP 

COBOL-OP 

ERROR-STATUS 


COBOLOP 

ERRORST 
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DOCGROUP  PS41260  Module  Documentation 
NAME:  CDRDF 

PURPOSE:  GENERATE  WS  IS  DATA  DEFINITIONS  FOR  RETRIEVED  DF ' S 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  CDRDF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  THE  WORKING  STORAGE 
INTERNAL  DATA  DEFINITIONFOR  THE  RETRIEVED  DATA 
FIELDS  THAT  WILL  BE  USED  IN  CONVERTING  INTERNAL 
FORMAT  TO  CONCEPTUAL  FORMAT. 

THIS  ROUTINE  WAS  UPDATED  MAY  8,  1986  INORDER  TO 
HANDLE  THE  COMPLEX  MAPPING  ALGORITHM  TABLE 
ENTRIES. 

UPDATED  9/88  TO  GENERATE  CODE  IN  COBOL,  C,  OR 
FORTRAN . 

Updated  8/89  to  provide  for  'c*  (due  to  ingresS  or  ingres6) 
character  strings  one  larger  than  the  is-size  to  hold  a 
null  terminator. 


ARGUMENTS : 


FCB-W  DSPLY[S9(9)] 

SUBTRANS-ID  DSPLY[9(3)] 

IS-ACTION-LIST  RECRD 

COMPLEX-MAPPING-ALG-TABLE  RECRD 

SOURCE-LANGUAGE  DSPLY [ X ( 10) ] 

FORTRAN-VARIABLE-TABLE  RECRD 

RET -STATUS  DSPLY [ X ( 5 ) ] 

INCLUDE  FILES: 


ERRFS 

ERRCDM 

ISAL 

CMA'^ 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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NAME:  CDRFT 

PURPOSE:  GENERATE  CS  DATA  DEFINITION  FOR  RETRIEVED  DF ' S 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRFT 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


_  ■? 


THIS  SUBROUTINE  LOOP  THROUGH  THE  RFT  TABLE  TO 
GENERATE  THE  COBOL  IDENTIFIER  FOR  EACH  ENTRY 
IN  THE  TABLE,  FOR  EXAMPLE  : 


01 

RESULT-REC. 

03 

RES-001 

PIC 

03 

RES-002 

PIC 

THIS  SUBROUTINE  WAS  UPDATED  MAY  8,  1986  INORDER  TO 
HANDLE  03  LEVEL  DATA  DEFINITIONS  FOR  THE  NULL 
FLAG  INDICATORS  INCLUDED  FOR  RELEASE  2.3. 

UPDATED  9/88  TO  GENERATE  CODE  IN  C,  COBOL,  OR  FORTRAN. 


ARGUMENTS : 


FCB-W 

SUBTRANS-ID 

RFT 

REC- LENGTH 
SOURCE-LANGUAGE 
FORTRAN-VARIABLE-TABLE 
RET-STATUS 


INCLUDE  FILES: 


ERRFS 

ERRCDM 

RFTABLE 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDPIC 

CDCREFO 

CDGETOF 

OUTFIL 

ERRPRO 
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DOCGROUP  PS41260  Module  Documentation 
NAME:  CDRPCIF 

PURPOSE:  GENERATE  A  COBOL  IF  STMT  FOR  USER  QUALIFICATIONS  EVAL 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRPCIF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 

DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  A  COBOL  IF  STATEMENT 
THAT  WILL  EVALUATE  USER  QUALIFICATIONS  CONTAINED 
IN  A  NDML  WHERE  CLAUSE.  THE  IF  STATEMENT  WILL  BE 
GENERATED  INTO  A  REQUEST  PROCESSOR  SUB  PROGRAM  TO 
PERFORM  THE  EVALUATION  OF  THE  WHERE  CLAUSE  AT  THE 
CONCEPTUAL  SCHEMA  LEVEL.  THIS  IF  STATEMENT  WILL 
BE  NECESSARY  FOR  ANY  UPDATE  TRANSACTIONS  THAT 
CONTAINED  COMPLEX  MAPPING  ALGORITHMS  IN  THE  WHERE 
CLAUSE. 

UPDATED  9/88  TO  GENERATE  CODE  IN  C,  COBOL,  OR 
FORTRAN. 


ARGUMENTS : 


RECRD 
RECRD 
RECRD 
RECRD 

DSPLY[9(3) ] 
DSPLY[S9(9) ] 
DSPLY[X(10) ] 
RECRD 

DSPLY[X(5)  ] 

INCLUDE  FILES: 


BOOLEAN-LIST 

CS-QUALIFY-LIST 

CS-ACTION-LIST 

IS-QUALIFY-LIST 

SUBTRANS-ID 

FCB-W 

SOURCE -LANGUAGE 

FORTRAN-VARIABLE-TABLE 

RET-STATUS 


CHKCDM 

ERRCDM 

ERRFS 

BOOLST 

CSQUAL 

CSAL 

ISQUAL 

FORVAR 

ERRPRO 

ROUTINES  CALLED: 


CDQPOP 

CDGETOF 

OUTFIL 

ERRPRO 
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NAME:  CDRPIIF 

PURPOSE:  GENERATE  A  COBOL  IF  STMT  FOR  USER  QUALIFICATIONS  EVAL 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRPIIF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  A  COBOL  IF  STATEMENT 
THAT  WILL  EVALUATE  USER  QUALIFICATIONS  CONTAINED 
IN  A  NDML  WHERE  CLAUSE.  THE  IF  STATEMENT  WILL  BE 
GENERATED  INTO  A  REQUEST  PROCESSOR  SUB  PROGRAM 
TO  PERFORM  THE  EVALUATION  OF  THE  WHERE  CLAUSE 
AT  THE  INTERNAL  SCHEMA  LEVEL.  THIS  IF  STATEMENT 
WILL  BE  NECESSARY  FOR  ANY  UPDATE  TRANSACTIONS  THAT 
CONTAIN  QUALIFICATION. 


ARGUMENTS : 


RECRD 

RECRD 

DSPLY[S9 (9)  ] 
DSPLY[9(3)  ] 
DSPLY[XP0)  ] 
DSPLY[X(30) ] 
DSPLY[X(5)  ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

SUBBOOL 

ISQUAL 

ERRPRO 


ROUTTNEb  CALLED: 


CDQPOP 

OUTFIL 

ERRPRO 


SUBTRANS-BOOLEAN-LIST 

IS-QUALIFY-LIST 

FCB-W 

SUBTRANS-ID 

CHARACTER-NULL 

NUMERIC-NULL 

RET-STATUS 
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DOCGROUP  PS41260  Module  Documentation 


NAME;  CDRPUIF 

PURPOSE:  GENERATE  A  COBOL  IF  STMT  FOR  USER  QUALIFICATIONS  EVAL 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDRPUIF 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM;  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  GENERATE  A  COBOL  IF  STATEMENT 
THAT  WILL  EVALUATE  RECORD  UNION  DISCRIMINATOR 
QUALIFICATION  FOR  A  SPECIFIED  RECORD  TYPE.  THE 
IF  STATEMENT  WILL  BE  GENERATED  INTO  A  REQUEST 
PROCESSOR  SUB  PROGRAM  TO  PERFORM  THE  EVALUATION 
AT  THE  INTERNAL  SCHEMA  LEVEL. 


RECRD 

RECRD 

DSPLY[9(6) ] 
DSPLY[S9(9) ] 
DSPLY[9(3) ] 
DSPLY[X(30) ] 
DSPLY[X(30) ] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRFS 

SUBBOOL 

ISQUAL 

ERR PRO 


ROUTINES  CALLED: 


OUTFIL 

CDQPOP 

ERRPRO 


ARGUMENTS ; 


SUBTRANS-BOOLEAN-LIST 

IS-QUALIFY-LIST 

RECORD-TYPE-NUMBER 

FCB-W 

SUBTRANS-ID 

CHARACTER-NULL 

NUMERIC-NULL 

RET-STATUS 
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DOCGROUP  PS41260  Module  Documentation 


NAME:  RETFLDS 

PURPOSE:  RETREIVE  ALL  FIELDS  OF  A  RECORD  INTO  A  TABLE 

LANGUAGE:  VAX-11  COBOL 

SOURCE  FILE:  RETFLDS 

SOURCE  FILE  TYPE:  PCO 

HOST : 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDML 


DESCRIPTION: 


THIS  ROUTINE  ASSUMES  THE  DF-TABLE  HAS 
BEEN  INITIALISED.  THE  INPUT  ARGUMENTS 
DB-ID  AND  RT-ID  SHOULD  BE  ENTERED  INTO 
THE  TABLE. 

ALL  THE  FIELDS  BELONGING  IN  THE  RECORD 
ARE  RETRIEVED  INTO  THE  TABLE. 

ZEROES  IN  DATA-TYPE-NAME  INDICATE  NULLS. 

MOD  2/89  -  REPLACE  ORACLE  STRUCTURED  TREE  QUERY  WITH 
ITERATIVE  FETCH  PROCESS  FOLLOWED  BY  A  SORT  INTO 
HIERARCHICAL  ORDER.  ALTHOUGH  FOR  THE  GE  REHOST 
TO  INGRES,  IT  MAKES  THE  ROUTINE  SQL-STANDARD. 

MOD  9/89  -  Change  zeros  to  spaces  for  null  data-type-name 


ARGUMENTS : 


RECRD 

DSPLY[X(5)  ] 


INCLUDE  FILES: 


ERRCDM 

EOD 

TDFTBL 

ERRPRO 


TDFT-TABLE 

RET-STATUS 
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ROUTINES  CALLED: 


SQLSCA 

SQLBSl 

SQLSCH 

SQLSCC 

SQLTOC 

SQLOSQ 

SQLADR 

SQLABl 

SQLEXE 

SQLCLS 

SQLADl 

SQLFCH 

ERRPRO 
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3.10.5  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  in  the  documentation  group  as  specified  in 
the  source  code.  The  language  it  is  written  in  is  also  given. 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  BOOLST 
PURPOSE:  BOOLEAN  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  BOOLEAN  OPERATORS,  PARENTHESES,  AND 
POINTERS  TO  THE  TYPE  2  CONDITIONS  FOR  AN  NDML 
TRANSACTION 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE  * 

CDMP  MODULES  * 

DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  CMAT 

PURPOSE:  COMPLEX  MAPPING  ALGORITHM  TABLE 

LANGUAGE :  VAX-11  COBOL 

DESCRIPTION: 


THIS  TABLE  IDENTIFIES  THE  SOFTWARE  MODULES  AND 
PARAMETERS  THAT  ARE  NEEDED  TO  PERFORM  COMPLEX 
MAPPINGS  BETWEEN  CS  AND  IS  FORMATS 

DOCGROUP  PS41260  Include  File  Description 

FILE  NAME:  COBOLOP 

PURPOSE:  WORKING  STORAGE  VARIABLES  OPERATOR  TRANSLATION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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DOCGROUP  PS41260  Iiiclude  File  Description 


FILE  NAME;  CSAL 

PURPOSE:  CONCEPTUAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


TABLE  TO  HOLD  CONCEPTUAL  DATA  ABOUT  THE  REQUEST 

NOTE!!!!!!  This  table  is  cloned  in  both  cdpre5  and  cdpre4 
so  any  changes  made  to  this  structure  needs  to 
be  made  in  these  cloned  versions.  Clone  version 
is  CSALX  for  CDPRE4 . 

NOTE  AGAIN  Any  changes  to  the  CS-ACTION-ENTRY  must  be 
reflected 

in  CDPlOB  in  the  C  code  generation  section.  The 
length  of  CS-STRING2  has  been  hard  coded  in  the 
generated  C  code  in  paragraph 
2 lO-GEN-MOVE-OF-TABLES . 

*****  THE  CONCEPTUAL  SCHEMA  ACTION  LIST 

DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  CSQUAL 

PURPOSE;  CONCEPTUAL  SCHEMA  QUALIFY  LIST 
LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  FOR 
THE  REQUEST'S  QUALIFICATION 


NOTE ! ! ! ! ! 

This  table  is  cloned  as  CSQUALX  in  CDPRE4 .  If  it 
is  changed,  CSQUALX  must  be  changed  also. 

THE  CONCEPTUAL  SCHEMA  QUALIFY  LIST 
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DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  EOD 

PURPOSE:  SQL  END  OF  DATA  DEFINITION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41260  Include  File  Description 


FILE  N/^E:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP  * 

MODULES  FOR  ERROR  HANDLING  * 

DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  ERRFS 

PURPOSE:  ERRFS. INC  -  FILE  I/O  PRIMITIVES  (FILE  SERVICES) 

LANGUAGE :  VAX - 1 1  COBOL 

DESCRIPTION: 


IISS  ERROR  CODES 

THIS  FILE  DEFINES  THE  FS  STATUS 
CODES  IN  COBOL  FORMAT 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  ERRORST 

PURPOSE:  WS  DEFINITION  FOR  ERROR  STATUS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


ERROR  STATUS  VARIABLE 
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FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  FORVAR 

PURPOSE:  FORTRAN  VARIABLE  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  TABLE  HOLDS  THE  ORIGINAL  FORTRAN  VARIABLE 
AND  ITS  GENERATED  SIX-CHARACTER  COUNTERPART. 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  I SAL 

PURPOSE:  INTERNAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  ABOUT  AN 
NDML  REQUEST 

DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  ISQUAL 

PURPOSE:  INTERNAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  QUALIFICATION 


THE  INTERNAL  SCHEMA  QUALIFY  LIST 
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DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  MACDAT 

PURPOSE:  WS  VARIABLES  FOR  MACRO  COPY  UTILITY 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  RFTABLE 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OF  AN  NDML  REQUEST 


THE  RESULT  FIELD  TABLE 

WHEN  CHANGING  THE  STRUCTURE  OF  THIS  TABLE 
DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  SBSTLST 

PURPOSE:  WS  DEFINITION  FOR  THE  SUBSTITUTION  LIST  TABLE 

LANGUAGE :  VAX - 1 1  COBOL 

DESCRIPTION: 


SUBSTITUTION-LIST  REPRESENTS  THE  INPUT  TABLE 
OF  SUBSTITUTION  PARAMETERS  FOR  THE  CDMACR 
MACRO  EXPANSION  SUBROUTINE 
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DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  SUBBOOL 

PURPOSE:  SUBTRANS  BOOLEAN  LIST 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  THE  BOOLEAN  OPERATORS,  PARENTHESES,  AND 
CONDITIONS  WHICH  CAN  BE  SATISFIED  AT  THE  INTERNAL 
SCHEMA  LEVEL,  FOR  EACH  SUBTRANSACTION. 


DOCGROUP  PS41260  Include  File  Description 


FILE  NAME:  TDFTBL 

PURPOSE:  TABLE  TO  HOLD  TEMPORARY  RECORD  DEFINITION  VARIABLES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION  : 

TABLE  TO  HOLD  INFORMATION  NEEDED  TO  DEFINE  A  RECORD 
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3.11  Program  Listings  Comments 


This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 
4 . 1  Introduct ion  and  De f in it ions 


"Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  IS  practical  and  possible  in  each  routine  should  be 
performed. 


4 . 2  Computer  Programminq  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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